home *** CD-ROM | disk | FTP | other *** search
-
-
-
-
-
-
-
-
-
-
-
-
- Qfind
-
-
- VERSION 2.2 - 08/19/93
-
-
-
-
-
- Qfind Copyright 1991,1992, 1993 by JebSoft and James E. Bell
-
-
- 135 Gunlock Trace
- Roswell, Georgia 30076
-
-
- Electronic Mail on Compuserve: 70270,534
-
-
-
-
-
-
-
-
-
-
- QFIND (Quick Find) is a set of utility programs that perform
- the function of finding the location of a file or files on
- your system. QFIND uses a different approach than most of
- the file-finding programs available today.
-
- FEATURES:
-
- * Extremely fast file name search.
-
- * Very easy to use.
-
- * DOS Command line version of programs.
-
- * Microsoft Windows 3.1 version of programs.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Qfind Version 2.0 - Page 2
-
-
-
-
-
-
- Files included in QFND20.ZIP:
-
- QFBUILD.EXE Builds file name database. DOS version
-
- QFIND.EXE File finder utility. Command line version
-
- QFBDLWIN.EXE Builds file name database. Windows version
-
- QFINDWIN.EXE File finder utility - Windows version
-
- THREE_D.DLL DLL file used in Qfindwin. This file
- should be located in your Windows
- directory
-
- QFINDWIN.INI Initialization file for QFINDWIN
-
- QFINDDOC.TXT Text version of documentation
-
- QFINDDOC.WRI Windows Write version of documentation
-
- QFINDHST.WRI History of changes for Qfind in Write
- format
-
- QFINDHST.TXT History of changes for Qfind in text
- format
-
- REGISTER.FRM Registration form
-
- REGISTER.WRI Registration form in Windows Write format.
-
- The following files are used by the Windows Install
- program. They are only needed for the installation.
-
- SETUPQF.EXE
- SETUPKIT.DLL
- VER.DLL
- FILES.DAT
- STARTUP.INI
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Qfind Version 2.0 - Page 3
-
-
-
-
-
-
- Qfind, like many DOS utilities, was born of necessity. I
- needed to find "that file". I did not know which directory
- contained the file, much less which disk contained the file.
- I pulled out one of the existing file find utilities and
- used it to search all my drives for "that file". After much
- disk activity, I found the file. I needed to find another
- file later and did the same thing. Most of my files (99.99%)
- had not changed their location on my system between
- searches. Why do all that disk activity each time I need to
- find a file when most of the files are still in the same
- location since the last time? Why not "remember" where all
- the files are located and use that information for later
- searches. If the file system has changed considerably since
- the last search, just build the file database again and use
- the new one to search.
-
- Qfind is a file finding system that does just that. Qfbuild
- builds a database that contains all files on all selected
- drives on your system. The search programs (Qfind and
- Qfindwin) then use that file to do their searches. This
- results in extremely fast search times since the actual file
- names in the disk directories are not needed again. On one
- of my machines that has a 200 meg and a 120 meg drive and
- 10,000+ files, the search time is less than 3 seconds. On
- another machine that has 2 32 meg logical drives, 8 network
- drives and over 15,000 files, the search time is less than 4
- seconds.
-
- ************************************************************
-
- Installation:
-
- All the files, except THREE_D.DLL and QFINDWIN.INI can be
- located in any directory of your choice. QFINDWIN.INI must
- be in the same directory as WIN.INI. THREE_D.DLL can be in
- any directory specified in the path statement. The
- recommended place is in the WINDOWS directory.
-
-
- ************************************************************
-
- QFBUILD.EXE
-
- Qfbuild is the DOS program that builds the database that
- contains all the file names and directory names on selected
- drives along with the optional switches for including Arc
- and Zip files. . It is executed from the command line with
- the following syntax....
-
- QFBUILD [-z] [-a] first_drive next_drive etc....
-
- The Arc and Zip switches must precede the drive letters.
- The "[ ]" are not included on the actual command line. They
- are here to show that these parameters are optional.
-
-
- Qfind Version 2.0 - Page 4
-
-
-
-
-
-
- If the -z switch is included, all ZIP files on the selected
- drives are searched to include their files names in
- Qfind.dat. The -a switch is for ARC files.
-
- Examples:
-
- QFBUILD -a c d e f g
-
- This would build a Qfind.dat containing all files in
- drives c, d, e, f, g and the internal directories of any
- ARC files found on these drives.
-
- QFBUILD -z e f g
-
- This would build a Qfind.dat containing all files in
- drives e, f, g and the internal directories of any ZIP
- files found on these drives.
-
- QFBUILD -a -z c: d: e: f: g:
-
- This would build a Qfind.dat containing all files in
- drives c, d, e, f, g and the internal directories of any
- ARC and ZIP files found on these drives.
-
- Qfbuild will take drive letters with or without the trailing
- ":" after the drive letter. The data file is built in the
- order of the drives on the command line. If you need to
- alter the order for some reason, just order the drives on
- the command line as you wish.
-
- Qfbuild sorts the file names in each subdirectory in
- ascending order. This was done to make it easier to
- visually read the output in Qfind or Qfindwin.
-
- The inclusion of the -z and -a switch is recommended.
- Qfind.dat would then contain all files on the selected disks
- including the files contained in the ARC and ZIP files.
-
- The only reason for leaving out the -z and -a switch on the
- command line would be to make Qfind.dat smaller. Qfind and
- QfindWin both have the ability to search for files either
- including or excluding ARC and ZIP files.
-
- Changing the location of the data file....
-
- Normally, the data file is written to the root directory
- of the C drive. If you need to change the location, add
- the variable QFIND to the environment. The variable QFIND
- is set to the drive and directory where you want the data
- file to be located. Example....
-
- Set QFIND=E:\QFIND
-
-
-
-
- Qfind Version 2.0 - Page 5
-
-
-
-
-
-
- QFBUILD will write the data file in the QFIND directory
- on the E drive and QFIND will look there to find the
- file.
-
- ***********************************************************
-
- QFIND.EXE
-
- Qfind is the command line version of the search program. It
- is executed with the very simple syntax as follows....
-
- QFIND [-x] [-g] search_mask
-
- Example:
-
- Qfind *.c
-
- The above command will find all the .C files on all selected
- drives and list them to the screen. I did not allow for
- multiple search masks because the search is so fast and the
- actual directory structure is not re-read for each search.
- If you need to find files with another search mask, just re-
- execute Qfind with the new search mask.
-
- The -x switch must precede the search mask parameter, and is
- used to exclude the search of the contents of any ARC or ZIP
- files. If the -x switch is added to the command line, Qfind
- will NOT search the contents of ARC or ZIP files.
-
- NOTE - If QFIND.DAT was not created with the contents of ARC
- or ZIP files selected, then Qfind cannot access the names in
- those files. Therefore the -x switch would have no effect.
-
- The -g switch provides a "GOTO" function to Qfind. If the -
- g switch is selected, it will change the current drive and
- the current directory to the drive and directory containing
- the matched file name.
-
- Example:
-
- QFind -g xyz.exe
-
-
- The current drive and current directory will be changed to
- the drive and directory that contains the FIRST occurrence
- of XYZ.EXE. If there are multiple copies of XYZ.EXE on your
- system QFind selects the first one matched in the data file
- built by QFBUILD. In this example, Qfind would also search
- the contents of any ZIP or ARC files since the -x parameter
- is omitted. If a file match were found in a ZIP file, Qfind
- would change the drive and directory to the drive and
- directory containing the ZIP file. If you don't want to
- match names in the ZIP or ARC files, just place the -x
-
-
-
- Qfind Version 2.0 - Page 6
-
-
-
-
-
-
- switch along with the -g switch on the command line like
- so....
-
- Qfind -x -g xyz.exe
-
-
- The search mask conforms to the standard DOS wildcard naming
- convention.
-
- Examples:
-
- QFIND ???e???.* Will find all files with an "E" in the
- 4th character of the file name.
-
- QFIND *.?X? Will find all files with an "X" in the
- 2nd character of the file type.
-
- QFIND ?abc*.exe Will find all .EXE files with "ABC" in
- the 2nd through the 4th position.
-
-
- QFIND looks for the data file in the root directory of the C
- drive unless the environment variable QFIND is set. See
- QFBUILD for example.
-
- QFIND will copy the selected files to the Windows clipboard.
- Just select Copy from the menu, and the main window contents
- will be copied to the clipboard.
-
- The Find dialog box can be automatically brought up when
- Qfindwin is launched. To select this feature, place a -f
- parameter in the Qfindwin command line like so...
-
- Go to Program manager and select the Qfind icon. Go to
- File, Properties and add -f to the execution line.
-
- Old execution line - QFINDWIN.EXE
- New execution line - QFINDWIN.EXE -F
-
- Qfindwin will now bring up the find dialog box when
- launched.
- ************************************************************
-
- QFBLDWIN.EXE
-
- This is the Windows 3.1 version of the build program. It
- can be launched by itself or from QFINDWIN.
-
- To use QFBLDWIN, launch it from the program manager, file
- manager, or QFINDWIN. It will present a shareware notice
- (bypassed in the registered version) and then present you
- with the main window. The windows controls are as follows:
-
-
-
-
- Qfind Version 2.0 - Page 7
-
-
-
-
-
-
- Drives - QFBLDWIN will display drives C thru Z and will grey
- out any drives with higher than are present in your system.
- If you have saved settings in the past, QFBLDWIN will check
- the same boxes that you selected last time. Otherwise
- QFBLDWIN will select all drives.
-
- Search Arc Files
- Search Zip Files
-
- The settings control the inclusion of ARC or ZIP
- directories. If they are checked, the respective ARC or ZIP
- directories will be included in QFIND.DAT.
-
- The inclusion of the ARC and ZIP directories is recommended.
- Qfind.dat would then contain all files on the selected disks
- including the files contained in the ARC and ZIP files. The
- only reason for not selecting them would be to make
- Qfind.dat smaller. Qfind and QfindWin both have the ability
- to search for files either including or excluding ARC and
- ZIP files.
-
- Save Settings
-
- If this box is checked the present settings (drive
- selections, ARC and ZIP selections) are save in
- QFINDWIN.INI.
-
- OK
-
- This will start the building of the new file database.
-
- Cancel
-
- Terminates the program without building a new database.
-
- When you press OK, QFBLDWIN will present you with a dialog
- box that shows you the running count of various files,
- etc.. At this point, you can minimize QFBLDWIN and let it
- do it's thing in the background.
-
- If you click on the CANCEL button, QFBLDWIN will terminate
- and leave the previous QFIND.DAT intact.
-
-
- QFINDWIN.EXE
- This is the Microsoft Windows 3.0/3.1 version of the search
- program. It uses the same search mask conventions as QFIND
- with an additonal feature.
-
- There is a special syntax that will find a string anywhere
- in the file name/file type. It is selected by not entering a
- period in the search mask. It is as follows:
-
- QFIND ab
-
-
- Qfind Version 2.0 - Page 8
-
-
-
-
-
-
-
- The above will find any file beginning with "ab". This is
- the same as entering a mask of "ab*.*".
-
- QFIND *ab
-
- The above will find any file with "ab" anywhere in the file
- name/file type. The above example would find files like
- abxxxx.xxx or xab.xxx.xxx or xxxxxab.xxx or xxxxxxxx.abx.
-
- To use QFINDWIN, execute it from Windows with either the
- program manager or the file manager. It will display a
- screen with "FIND", "BUILD", "COLOR", and HELP on the menu.
-
- Click on FIND and a drop down menu will appear. It has the
- following items:
-
-
- Find This selection will display a dialog box asking
- for the search mask.
-
- About This selection will display the "About" dialog
- box.
-
- Exit This selection will exit the program.
-
- Click on BUILD to launch QFBLDWIN and build a new file
- database.
-
- Click on COLOR the set the color settings of QFINDWIN. The
- color menu consists of 2 items....
-
- USE COLOR - This is a toggle. If a checkmark appears by
- the USE COLOR, QFINDWIN will use color to display the
- directory, file and zip entries. Otherwise bolding,
- normal, and italic BLACK is used. To change the USE
- COLOR setting, just click on the menu item. The check
- will reverse state with each click.
-
- SET COLOR - Clicking on this item will display the set
- color dialog box. If USE COLOR is not checked, this
- item will be grayed out and will not be selectable.
- When this item is selected, it will present a set color
- dialog box. To use the dialog box do the following....
-
- Select the DIRECTORY, FILE, ZIPS/ARCS by clicking on the
- appropiate button. This will set the 3 scroll bars to the
- present value of this selection. Drag the scroll bars to
- set the colors that you want. NOTE - On a 16 color system,
- the colors will not change smoothly. On a 256 color system,
- the change will be much smoother. Continue selecting each
- file type and selecting the color combination for each.
-
-
-
-
- Qfind Version 2.0 - Page 9
-
-
-
-
-
-
- If the SAVE SETTINGS box is checked, these settings will be
- saved in QFINDWIN.INI.
-
- To search for files......
-
- Click on Find and enter the search mask in the text box.
- click on OK and the matched file names will appear in the
- main box. If there are more matches than will fit in the
- window, vertical scroll bars will appear. You can use
- these vertical scroll bars to move the text around.
-
- You can use the following scroll bar items.....
-
- Scroll UP (UP arrow) - Each click will scroll the file
- names UP one line.
-
- Scroll DOWN (DOWN arrow) Each click will scroll the file
- names DOWN one line
-
- Scroll Page UP - Each click will scroll the file
- UP one page.
-
- Scroll Page DOWN - Each click will scroll the file
- DOWN one page.
-
- Move with Thumb - You can move the display of
- file names back and forth with the thumb
- control. The thumb control is the
- little square box in the vertical scroll
- bar. If you move the thumb to the half-
- way location, the display of file names
- will move down to the middle, etc.
-
- Click on the ARC or ZIP checkbox to toggle the ARC and ZIP
- file setting. If an "X" appears in the checkbox, QfindWin
- will search for file name matches within ARC and ZIP files.
-
- NOTE - If QFIND.DAT was not created with the contents of ARC
- or ZIP files selected, then Qfindwin cannot access the names
- in those files. Therefore the state of the checkboxes will
- have no effect.
-
- If the color option is not selected, the text is shown as
- follows. DIRECTORY names are shown in bold font. FILE names
- are shown in normal font. File names that are found within
- ARC or ZIP files are shown in italic type with the ARC or
- ZIP name shown surrounded by "**".
-
- If the color option is selected, the text is shown in the
- colors selected by the color setting selected in the SET
- COLOR dialog box.
-
- QFINDWIN.INI
-
-
-
- Qfind Version 2.0 - Page 10
-
-
-
-
-
-
- All parameters for QFINDWIN are located in this file.
- QFINDWIN no longer looks in WIN.INI for anything.
- QFINDWIN.INI must be located in the same directory as
- WIN.INI.
-
- There are 2 different sets of parameters contained in
- QFINDWIN.INI. A set of parameters for QFINDWIN, and a set
- for QFBLDWIN. All parameter, except for 1 (QFDIR) are
- automatically set by the save settings function of QFINDWIN
- and QFBLDWIN.
-
- A sample QFINDWIN.INI file is included.
-
- QFINDWIN uses the QFINDWIN.INI entry to find the data file
- instead of the environment method. To tell QFINDWIN where
- the data file is located, place the following 2 lines in the
- QFINDWIN.INI file....
-
- [qfind]
- FILE = d:\temp OR wherever the data file is
- located.
-
-
- If there is no entry in the QFINDWIN.INI file, QFINDWIN will
- look for the data file in the root directory of drive C.
-
- Note........
- THREE_D.DLL must be located in a directory that is defined
- in your path for QFINDWIN to display in the 3D look. The
- preferred location is in your Windows directory.
-
- ************************************************************
-
- Support....
-
- I can be reached on Compuserve. My ID is 70270,534
-
-
- This is Version 2.0 of Qfind. I would appreciate feedback
- on suggested additional features in the next version,
- problems with this version, etc....
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Qfind Version 2.0 - Page 11
-
-
-
-
-
-
- Installation.......
-
- With version 2.0 a new installation program is included.
- This is only used if an automatic installation is desired.
-
- There are basically 3 ways to install the Qfind
- programs.......
-
- If the DOS versions are the only things that are going to be
- used, simply copy the required files to a directory of your
- choice.
-
- The files are:
-
- Qfind.exe
- Qfbuild.exe
- Qfinddoc.txt
- Qfindhst.txt
-
- If you want to manually copy all files (including the
- Windows stuff), do the following....
-
- Copy the following files to a directory of your choice.
-
- Qfind.exe
- Qfbuild.exe
- Qfindwin.exe
- Qfbldwin.exe
- Qfinddoc.txt
- Qfinddoc.wri
- Qfindhst.txt
- Qfindhst.wri
-
- Copy the following file to the \Windows\System directory
-
- Three_D.Dll
-
- Copy the following file to the \Windows directory
-
- Qfindwin.ini
-
- Automatic installation.....
-
- Execute the SETUPQF.EXE from the program manager or file
- manager. Setupqf will automatically install the various
- file in the proper directories.
-
- NOTE--- SETUPQF.EXE requires VISUAL BASIC's run-time
- module (VBRUN100.DLL). If you don't have it, you can get
- it from Compuserve.
-
-
-
-
-
-
- Qfind Version 2.0 - Page 12
-
-
-
-
-
-
- Registration
-
- Registering QFIND will get you the latest version of the
- programs along with a utility that will personalize your
- copy and remove the start-up message in QFINDWIN.
-
-
- Where to find QFIND:
-
- The latest version of Qfind.zip can always be found on The
- Atlanta Windows BBS. The BBS phone numbers are:
-
- (404) 516-0048 (public) USR Dual Std w/fax 16,800 bps
- (404) 516-9845 (private) USR Dual Standard 16,800 bps
- (404) 516-9898 (private) USR Dual Standard 16,800 bps
- (404) 516-9385 (public) USR Dual Std w/fax 16,800 bps
- (404) 516-1773 (private) USR Dual Std w/fax 16,800 bps
- (404) 516-1588 (public) USR Dual Std w/fax 16,800 bps
- (404) 516-1883 (public) USR v.32 bis 14,400 bps
-
- Also Qfind.zip can be found in the WINSHARE forum on
- Compuserve.
-
- Disclaimer:
-
- Users of QFIND, QFINDWIN, QFBLDWIN, and QFBUILD must accept
- this disclaimer of warranty: "QFIND, QFINDWIN, QFBLDWIN, and
- QFBUILD are supplied as is. The author disclaims all
- warranties, expressed or implied, including, without
- limitation,the warranties of merchantability and of fitness
- for any purpose. The author assumes no liability for
- damages, direct or consequential, which may result from the
- use of these programs."
-
- LICENSING AGREEMENT:
-
- QFIND, QFINDWIN, QFBLDWIN, AND QFBUILD are Copyright 1991,
- 1992 by JebSoft and James E. Bell 135 Gunlock Trace,
- Roswell, Georgia 30076
-
- This program is made available through Shareware for
- personal use on non-business PC's only. If you find these
- programs useful and find that you are using them and
- continue to use them after a reasonable trial period, you
- must make a registration payment of $10.00 to James E. Bell.
-
- Use of this program by any business, corporation, government
- agency, or any other institution is prohibited without
- payment of $10.00 to James E. Bell for each installed PC.
-
- In accordance with the Shareware distribution method, all
- users are granted a limited license to copy QFIND, QFINDWIN,
- QFBLDWIN ,and QFBUILD for the trial use of others providing
- that there programs are:
-
-
- Qfind Version 2.0 - Page 13
-
-
-
-
-
-
-
- Copied in their original archive form.
-
- Not modified in any way and are distributed with the
- full and unmodified documentation.
-
- Are not sold or traded for money or any other
- consideration by any party other than JebSoft and James
- E. Bell
-
- Not distributed in conjunction with any other product
- or software without the written consent of James E.
- Bell.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Qfind Version 2.0 - Page 14
-